home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 April: Mac OS SDK / Dev.CD Apr 96 SDK / Dev.CD Apr 96 SDK1.toast / Development Kits (Disc 1) / OpenDoc / Sample Code / Sample Editors⁄Viewers / About Sample Parts < prev    next >
Encoding:
Text File  |  1995-12-15  |  4.9 KB  |  138 lines  |  [TEXT/ttxt]

  1. About Sample Parts
  2. By The OpenDoc™ Sample Code Team
  3. December 15, 1995
  4.  
  5.  
  6. © 1993-1995  Apple Computer, Inc. All Rights Reserved.
  7. Apple, the Apple logo, and Macintosh are registered trademarks of Apple Computer, Inc.
  8. Mac and OpenDoc are trademarks of Apple Computer, Inc.
  9. ------------------------------------------------------------------------------------------------------------------------------
  10.  
  11.  
  12. SamplePart 
  13.  
  14. This part is the most basic part as it does not contain any intrinsic content.  This part simply displays the part's name as a text string.  This part is used as the base code for all the sample code parts, and it implements the following features of OpenDoc:
  15.  
  16.             - System Object Model™ (SOM) wrapper / C++ implementation
  17.             - lazy display frames handling
  18.             - drawing in 4 standard view types
  19.             - part persistency
  20.             - basic event handling
  21.    - multiple display frames/windows
  22.  
  23. SamplePart  C
  24.  
  25. This part has the same functionality and features as SamplePart, except it is written as a SOM class in C.
  26.  
  27.  
  28. Cappuccino
  29.  
  30. This part is a simple editor designed to be a "starting point" for leaf part development.  This part implements a very a basic content model (i.e., a pascal string) and implements the majority of OpenDoc features a leaf part might want to provide.  This part implements the following features of OpenDoc:
  31.  
  32.             - SOM wrapper / C++ implementation
  33.             - lazy display frames handling
  34.             - drawing in 4 standard view types
  35.             - part persistency
  36.             - basic event handling
  37.    - multiple display frames/windows
  38.             - clipboard operations
  39.    - drag and drop
  40.    - undo
  41.    - translation (with or without Paste As dialog)
  42.    - promises (used for interchange)
  43.             - handling of part menus
  44.             - settings dialog and extension
  45.             - dialogs
  46.    - zoom rects when opening/closing
  47.             - scripting (ODSemantic extension subclass)
  48.    - being embedded in a link source or destination
  49.             - old file/data type nmap resource
  50.    - multiple kind support
  51.  
  52.  
  53. Picture Viewer
  54.  
  55. PictureViewer allows users to drop arbitrary PICT data into OpenDoc™ documents.  Pictures may be cropped or scaled to the frame, the default mode being cropped.  As this part is a “viewer”, content is not editable, nor is it saved within the PictureViewer root document.  PictureViewer as the root part does nothing (as a viewer should).  
  56.  
  57. In addition to the features listed in SamplePart, this part implements the following OpenDoc features:
  58.  
  59.             - SOM class implementation
  60.             - limited clipboard support, including promises
  61.             - viewer implementation
  62.             - handling of part menus
  63.             - viewer nmap and old file/data type nmap resources
  64.  
  65.  
  66. Sound Editor
  67.  
  68. The SoundEditor part allows users to record, playback, save, and re-record sounds from the current audio input device.  It supports data stored in Mac SND format.
  69.  
  70.             - SOM wrapper / C++ implementation
  71.             - clipboard support
  72.             - idle event handling
  73.             - handling of part menus
  74.             - settings dialog and extension
  75.             - old file/data type nmap resource
  76.             - dialogs
  77.             - scripting (ODSemantic extension subclass)
  78.    - balloon help
  79.  
  80.  
  81. Text Editor
  82.  
  83. Based on Textension, this part is similar to SimpleText.  It supports Mac TEXT data as well as native data formats.  In addition to the features mentioned above in SamplePart, this part implements the following:
  84.  
  85.             - SOM class implementation
  86.             - handling of part menus
  87.             - drag and drop
  88.             - scrolling (when root of document)
  89.             - international TSM support
  90.             - preferences file
  91.             - settings and preferences dialogs
  92.             - supports Semantic Interface to handle TSM Apple events
  93.    - multiple kind support
  94.    - support for ScriptRunner
  95.  
  96.  
  97. DrawEditor
  98.  
  99. This part is based on Quickdraw and provides tools for creating and editing shapes.  Beyond the SamplePart features, this part implements:
  100.  
  101.    - SOM wrapper / C++ implementation
  102.    - handling of part menus
  103.    - drag and drop
  104.    - floating palettes
  105.    - embedding
  106.    - storage of native and embedded content
  107.    - embedded part event handling
  108.    - sequenced frames
  109.  
  110.  
  111. ScriptRunner
  112.  
  113. The OSA Plug-In and ScriptRunner part provide OSA scripting capabilities, such as compiling and executing scripts.  The TextEditor part supports ScriptRunner, and the ScriptRunner palette is enabled from a menuitem in TextEditor.   This part implements the following features:
  114.  
  115.    - SOM class implementation
  116.    - floating palettes
  117.    - dragging (of result value)
  118.    - extensions
  119.    - inter-part communication through extensions
  120.    - Plug-In
  121.  
  122.  
  123. PanelEditor
  124.  
  125. The Panel Editor is provided as a more simple embedding example. The part allows the user to embed items in a scrolling list and click on the items to change a "panel" display. The interface is similar to many preference dialogs in popular applications. This part implements the following features:
  126.  
  127. (Note: Panel Editor is work in progress)
  128.  
  129.    - SOM wrapper/C++ class implementation
  130.    - use of non-persistent frames
  131.    - drag and drop
  132.    - scrolling embedded content
  133.    - embedding of arbitrary content
  134.    - clipboard operations on embedded content
  135.    - undo (incomplete)
  136.  
  137.  
  138.